home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
doors_2
/
sfrom100.zip
/
SFROM.DOC
< prev
next >
Wrap
Text File
|
1992-05-31
|
22KB
|
482 lines
SF ROM DOOR
Version 1.0
Released May 31, 1992
Copyright (C) 1992
by Mike Robinson
The Soft Parade
Shelton, Connecticut, USA
203-924-5603
------- OVERVIEW ------------------------------------------------------------
SF ROM Door is a file access door designed for use on Spitfire BBS.
It can be used to access file areas on a CD-ROM disk, a "normal"
magnetic disk, or both. It provides browsing, text search and
download capabilities from within the door. It can even track the
number of files/bytes downloaded, enforce daily limits, and then
record this information in the main Spitfire database. A Spitfire
SFFILES.BBS type of file list is required for each file area. The
door can be run from the door menu or any of the menu extensions.
Speed.
Nothing in this world ever seems to go fast enough. Right from the
beginning this door was designed and optimized for speed. And it is
FAST. I know of no other door that even comes close. A file search of
a 500 megabyte CD-ROM disk takes only a few seconds.
Speed is especially important to those who run multiple nodes and/or
multiple CD-ROM drives such as the Pioneer DRM-600 "six pack."
Considerable time and energy was spent working around the speed
limitations of today's CD-ROM drives. Actual CD-ROM drive hardware
access time has been minimized by:
1. Maintaining the file lists on the magnetic drive. This is
optional. If the CD-ROM itself contains file lists, these can be
be accessed directly by the door in order to save hard drive
space.
2. Copying the file to a holding directory on the hard drive and
downloading it from there. This is also optional. You can
configure the door to download directly from the CD-ROM drive.
3. Careful design of the the door logic. The CD-ROM drive hardware is
accessed as rapidly as possible and only when absolutely required.
------- FEATURES ------------------------------------------------------------
■ Number of files/bytes downloaded is recorded in the Spifire main
database and daily download limits are enforced.
(This feature is NOT available in unregistered versions.)
■ Caller time in door is limited to remaining time allowed on BBS.
(This feature is available in ALL versions.)
■ Complete logging of all caller activity.
(This feature is NOT available in unregistered versions.)
■ Download from within door using Xmodem, Ymodem or Zmodem.
A copy of DSZ.COM or DSZ.EXE by Omen Technology Incorporated
is required.
■ Up to 1000 separate file areas.
■ Very rapid text search of both file names and descriptions.
Matches are highlighted in color.
■ File sharing and locking for multinode and network operation.
All file lists, menus, data files and logs may be shared.
DOS version 3.0 or higher, with DOS SHARE installed, is required
for proper operation of file sharing and locking.
■ DESQview aware. When idle the program automatically releases
it's clock ticks to applications running in the other windows.
■ Multi-colored file lists just like seen in Spitfire 3.2.
■ Run as a door or menu extension using SFDOORS.DAT, SFFILE.DAT,
SFMESS.DAT or SFMAIN.DAT.
■ Automatically uses Spitfire's communication port settings.
Comm port speeds to 38,400 bps with hardware or software flow
control. Uses Spitfire's configured port speed, data bits, stop
bit, parity, comm port, I/O port and interrupt. Handles any UART.
Does not require or use a FOSSIL driver, but is compatible with a
FOSSIL if one is installed.
■ Detailed status line visible on top of local screen at all times.
Shows caller name, statistics, time left, etc.
■ Detailed status screen displayed during download.
Shows callers's entire download/upload history and more.
■ Sysop local keyboard controls same as Spitfire:
ALT+C --- Chat Mode On/Off
ALT+D --- Drop To DOS (local sysop only)
ALT+J --- Drop To DOS (local sysop only)
F6 ------ Take Five Minutes From Caller
F7 ------ Give Five Minutes To Caller
F10 ----- Exit The Door
ALT+F1 -- Exit The Door
ALT+F2 -- Exit The Door
■ Carrier detection. Resets the BBS if caller drops carrier.
■ Inactivity timeout configurable from 1 to 10 minutes.
■ ANSI color or plain ASCII text modes. Initial mode is the same as
passed by Spitfire. Caller can toggle ANSI on/off from within the
door. Door contains its own ANSI driver and can show ANSI graphics
on the local screen even if DOS ANSI.SYS is not loaded.
■ Sysops can design their own (optional) custom screens.
Door will display WELCOME.CLR or WELCOME.BBS before it runs.
Door will display GOODBYE.CLR or GOODBYE.BBS after it runs.
Place these in the same directory as SFROM.EXE.
If ANSI is on then the .CLR files will be shown, otherwise
the .BBS file will be shown.
■ Low memory requirements. Only uses about 120 kilobytes.
------- SETUP ---------------------------------------------------------------
1. Unzip this archive into one subdirectory.
This will be the SFROM home directory.
2. Modify the included SFROM.CFG file to meet your needs.
Any line in SFROM.CFG that does not begin with a letter is
ignored. The lines that begin with semicolons, for example, are
used for comments and ignored by the program. See detailed
instructions for each line of SFROM.CFG below.
Keep this file in the SFROM home directory.
3. Modify the included AREALIST.CLR and AREALIST.BBS to meet your
needs. These two files are the main program menu and are mandatory
or the program will not run. Try to keep these to under 21
displayed lines or the top may scroll off the screen.
Keep these files in the SFROM home directory.
4. Make sure a copy of DSZ.COM or DSZ.EXE is somewhere on your DOS
path or in the SFROM home directory.
5. (OPTIONAL) Place custom screens WELCOME.CLR, WELCOME.BBS,
GOODBYE.CLR and GOODBYE.BBS in the SFROM home directory.
The door will display these files if they exist.
6. Run the program using any ONE
of these command lines:
COMMAND LINE
------------
SFROM C:\SF\SFDOORS.DAT ( doors menu )
SFROM C:\SF\SFFILE.DAT ( file menu extension )
SFROM C:\SF\SFMAIN.DAT ( main menu extension )
SFROM C:\SF\SFMESS.DAT ( message menu extension )
SFROM LOCAL ( local test mode )
The complete path and file name must be specified except for
local mode as shown. Spitfire creates one of the above files
whenever the door menu or one of the menu extensions is executed.
(OPTIONAL)
All of the above examples assume that a configuration file named
SFROM.CFG is in the SFROM home directory. You may also specify a
different configuration file on the command line like this:
SFROM C:\SF\SFFILE.DAT C:\SF\CDROM2\MYCONFIG.FIL
------- SFROM.CFG -----------------------------------------------------------
SFROM.CFG is the main configuration file which supplies the door with
the information it requires to run properly. It should be placed in
the SFROM home directory. The program reads each line in this file.
If the line begins with a keyword then the configuration is modified
according to the information that follows the keyword. If a line
begins with anything other than a letter, it is ignored. The
explanatory comments below are all on lines beginning with
semicolons. The order of the lines is generally not important except
for the file areas. The keywords are NOT case sensitive, but they
must be spelled correctly.
DiskName So Much Shareware
; This name is used in the door log entries. It is only used in
; registered versions.
HoldDir C:\SF\CD-HOLD
; If this keyword is used, then files selected for download will be
; copied to the directory specified. If this keyword is not used then
; files will be downloaded directly from the CD-ROM.
; Default is the root directory C:\
; The program takes care of its own housekeeping and deletes the
; copied files after the download. Just the copied files are deleted.
; Any other files that exist in this directory will NOT be deleted.
LogName C:\SF\CALLERS.TMP
; Registered versions only.
; Gives the name of the caller activity log file.
; Default is CALLERS.TMP in the Spitfire home directory for this
; node as defined in SFFILE.DAT or equivalent.
Share ON
Share OFF
; Turns file sharing and locking ON or OFF.
; File sharing is generally not required on a single-node BBS.
; This program will run much faster with Share OFF.
; The default is Share ON.
TimeOut 180
; This is the caller inactivity timeout delay in seconds.
; If no keystrokes are received for this length of time, the door
; will exit and return the caller to the BBS.
; Values from 60 to 600 seconds are allowed.
; The default value is 180 seconds (3 minutes).
ScrollDelay 3
; This is the delay in milliseconds between display of each line.
; You should probably not mess with this.
; Values from 0 to 30 are allowed.
; The default is 3.
Debug ON
Debug OFF
; Most program error conditions are logged to SFROM.LOG if Debug is
; turned on. The program may load a bit faster if you turn this off.
; If you are experiencing difficulties, leave Debug ON.
; The default is Debug ON.
DirectVideo ON
DirectVideo OFF
; With DirectVideo ON, all local screen writes will done directly to
; video memory instead of through the BIOS.
; The default is DirectVideo ON. This seems to work fine on most
; systems.
CheckSnow ON
CheckSnow OFF
; CheckSnow ON enables "snow checking" when using DirectVideo ON.
; It has no effect if DirectVideo OFF.
; Some older CGA dipsplays may requires this. It should not be a
; problem on most monochrome, EGA or VGA video systems.
; Some systems may run a bit faster with CheckSnow OFF.
; The default is CheckSnow ON.
BiosScroll ON
BiosScroll OFF
; If BiosScroll OFF, then a special scrolling routine is used that
; suppresses snow and flicker on systems with any kind of color
; graphics. However, BiosScroll ON is a bit faster.
; The default is BiosScroll ON.
; The following defines your file areas. This is VERY IMPORTANT.
; These must be one area per line on consecutive lines. The first
; line is file area number 1 and the rest follow in order until you
; reach the end.
; The list MUST BEGIN and END with the keyword "Areas".
; The list MUST BEGIN and END with the keyword "Areas".
; Each line has two entries separated by at least one blank space.
; The first is the path to the file area on the CD-ROM. The second is
; the full path and filename of the associated file list. The list
; can have any filename, it does not have to be sffiles.bbs.
Areas
E:\ASM C:\SF\CDROM1\ASM.LST
E:\BUDGET C:\SF\CDROM1\BUDGET.LST
E:\CLIPART C:\SF\CDROM1\CLIPART.LST
E:\CPROG C:\SF\CDROM1\CPROG.LST
E:\DATABASE C:\SF\CDROM1\DATABASE.LST
E:\DEMOS C:\SF\CDROM1\DEMOS.LST
E:\DESKTOP C:\SF\CDROM1\DESKTOP.LST
E:\EDUCATE C:\SF\CDROM1\EDUCATE.LST
E:\FINANCE C:\SF\CDROM1\FINANCE.LST
E:\GAMES1 C:\SF\CDROM1\GAMES1.LST
E:\GAMES2 C:\SF\CDROM1\GAMES2.LST
E:\GENERAL C:\SF\CDROM1\GENERAL.LST
E:\GIFS C:\SF\CDROM1\GIFS.LST
E:\GRAPHICS C:\SF\CDROM1\GRAPHICS.LST
E:\HOBBY C:\SF\CDROM1\HOBBY.LST
E:\LASER C:\SF\CDROM1\LASER.LST
E:\MODEM C:\SF\CDROM1\MODEM.LST
E:\MUSIC C:\SF\CDROM1\MUSIC.LST
E:\PASCAL C:\SF\CDROM1\PASCAL.LST
E:\PROG C:\SF\CDROM1\PROG.LST
E:\QB C:\SF\CDROM1\QB.LST
E:\SOSGIFS C:\SF\CDROM1\SOSGIFS.LST
E:\SWIMSUIT C:\SF\CDROM1\SWIMSUIT.LST
E:\UTIL1 C:\SF\CDROM1\UTIL1.LST
E:\UTIL2 C:\SF\CDROM1\UTIL2.LST
E:\WIN1 C:\SF\CDROM1\WIN1.LST
E:\WIN2 C:\SF\CDROM1\WIN2.LST
E:\WORD C:\SF\CDROM1\WORD.LST
Areas
; The file lists can be located on a normal magnetic hard disk or on
; the CD-ROM (if they exist on the CD-ROM). The door will run much
; faster if you locate the file lists on the normal magnetic hard
; disk. Note that you can also use this door to access normal file
; areas on your hard drive. You can mix normal file areas with CD-ROM
; areas in the same door. The file areas do not have to reside on the
; same drive letter or same physical drive. If you have a network,
; you can access file area on a different machine. You could even put
; ALL of your Spitfire file areas in one or more of these doors. For
; example, you could put all your naked-lady GIFs in one door and
; restrict access to adults only. Or you could have special file
; doors reserved for privileged, contributing or subscribing callers.
; The example above is also used in the sample SFROM.CFG supplied in
; this package. It is for the "So Much Shareware #1" CD-ROM disk
; first published in late 1991. The file lists are resident on the
; CD-ROM as SFFILES.BBS in each subdirectory and can be easily
; copied to a hard drive.
------- REGISTRATION --------------------------------------------------------
This is SHAREWARE. You may use this program for a free 30 day trial
period. After that, you must register it or stop using it.
You may give away free copies of this entire unmodified package,
but you may not sell it. I retain all rights to this program.
As an incentive to encourage registration, the following features
are ONLY AVAILABLE IN THE REGISTERED VERSION:
■ The *** UNREGISTERED *** message on the first screen is replaced
by your name and your BBS Name.
■ Spitfire's daily download file and byte limits will be enforced by
the door. The door will also record all downloads and add the
number of files and bytes downloaded to the main Spitfire data
base. So the caller's total daily downloads (sum of downloads
inside the door and normal Spitfire downloads) will never be more
than allowed by Spitfire in DAILYLMT.DAT. These limits are
correctly tracked in any combination, even if the caller enters and
exits the door several times. If Spitfire says a caller can only
grab 10 files per day, he will only be able to grab 10 files total
per day.
example:
A caller is allowed 10 downloads per day. He downloads 3 files in
this door. He is then only allowed 7 more downloads when he
returns to Spitfire.
In the unregistered version, only the caller's daily time limit is
enforced. In the unregistered version, downloads are not recorded
and file/byte per day limits are not enforced.
■ Full logging of all caller activities in the door to CALLERS.LOG
or any file you choose. These log entries are designed to blend
nicely with the normal Spitfire log entries.
Here is an example from the CALLERS.LOG on my BBS:
-------------------------------------------------------------------
John Smith called at 19:06:46 on 05-18-92 using Node 1 at 2400 baud.
ANSI Color Graphics Selected.
Entered So Much Shareware SF-ROM Door at 19:09:16
117,730 05-17-90 A Star Trek Game For Vga Only!
Begin DownLoad VGATREK.ZIP 19:20:22 Estimated Time: 8.5 Min.
End DownLoad VGATREK.ZIP 19:28:51 Actual Time: 8.5 Min.
Updated caller download records +1 file.
15,269 09-05-91 Grab Address From App & Print Envelope
Begin DownLoad WNVEL20.ZIP 19:40:03 Estimated Time: 1.1 Min.
End DownLoad WNVEL20.ZIP 19:41:12 Actual Time: 1.1 Min.
Updated caller download records +1 file.
Exited So Much Shareware SF-ROM Door at 19:42:50
John Smith logged off at 19:43:20
-------------------------------------------------------------------
In the unregistered version, only error conditions are logged.
No caller activity log is created in the unregistered version.
Registration is $15 (fifteen) dollars in US funds.
Personal check, bank check or money orders are acceptable.
Registered Sysops are entitled to free program support, free upgrades
to all future versions, and free access to all files and features on
my BBS. Support is available from me on my BBS, in CircuitNet and in
FidoNet. Suggestions for future improvements from registered Sysops
will receive careful consideration.
In order to register the program, you will have to call my BBS and
download your personal registration key and instruction file.
This key will work for all future versions, so there will be no need
to download any specially compiled versions of the executable program
itself.
If you do not yet have access to my BBS, please be sure to send
along a password and birthdate with your registration. Then I can set
up your logon account in advance. Please be sure to specify your name
and your BBS name exactly as you would like them to appear on the
first door screen.
-------------------------------------------------------
-------------------------------------------------------
-------------------------------------------------------
SF ROM Door REGISTRATION FORM
Your Name:
(40 characters maximum)
BBS Name:
(40 characters maximum)
BBS Phone Number:
(xxx-xxx-xxxx)
Password to use on Mike Robinson's BBS:
(14 characters maximum)
BirthDate to use on Mike Robinson's BBS:
(mm-dd-yy)
Your Address:
Send this form and $15 (fifteen) dollars in US funds to:
Michael Robinson
9 Richard Boulevard
Shelton, CT. 06484
Personal check, bank check or money orders are acceptable.
-------------------------------------------------------
-------------------------------------------------------
-------------------------------------------------------
╔═══════════════════╗ ╔══════════════════════╗ ╔═══════════════════╗
║ The Soft Parade ║ ║ Sysop: Mike Robinson ║ ║ 1200 to 14400 bps ║
║ Shelton, CT. USA ║ ║ Spitfire version 3.2 ║ ║ HST V.32 V.42 ║
║ 203-924-5603 ║ ║ Open 24 hours 7 days ║ ║ MNP 5 V.42bis ║
║ FidoNet 1:141/485 ║ ║ CircuitNet 203004 ║ ║ USR Dual Standard ║
╚═══════════════════╝ ╚══════════════════════╝ ╚═══════════════════╝
Thanks to beta testers Bill Arlofski, Dave Clark, Don Hutson,
Ed Miller, Steve Newman.
Legal Stuff:
Use this program at your own risk. No guarantees of any sort.
"Spitfire" is a registered trademark of Buffalo Creek Software.
File sharing and locking implemented via BCSHARE Beta Version 0.7
Copyright (C) By Mike Woltz 1990 Buffalo Creek Software.
SF ROM Revision History -
Version 1.0 - Initial Public Release - May 31, 1992
And God said: 'Let there be light.' And there was light.
And God saw the light, that it was good;
and God divided the light from the darkness.
- Genesis 1.1
_
Las·er (la'zer) n. [l(ight) a(mplification by) s(timulated)
e(mission of) r(adiation)] a device containing a crystal, gas,
or other suitable substance, in which atoms, when stimulated by
focused light waves, amplify and concentrate these waves, then
emit them in a narrow, very intense beam
- Webster's New World Dictionary